home *** CD-ROM | disk | FTP | other *** search
/ World of Education / World of Education.iso / world_q / quiz110.zip / QUIZ.DOC < prev    next >
Text File  |  1992-10-23  |  21KB  |  477 lines

  1.  
  2.  
  3.                       CREATE A QUIZ
  4.  
  5.                        Version 1.1
  6.  
  7.  
  8. Description:
  9.  
  10.      CREATE A  QUIZ is  a simple  yet comprehensive  program
  11. that  can  be  used  to  create and take multiple-choice and
  12. fill-in-the-blank quizzes.   This one  program can  be  used
  13. by both the teacher and student.
  14.  
  15.      Teachers can create on-screen quizzes that can be  used
  16. by  students,  or  create  hardcopy  quizzes if a printer is
  17. available.
  18.  
  19.  
  20. Special features:
  21.  
  22.      A) Pop-up menus, mouse support, full line text  editing
  23. capabilities make using CREATE A QUIZ simple and fun.
  24.  
  25.      B)   Both   multiple-choice   and   fill-in-the   blank
  26. questions can be used in the same quiz.
  27.  
  28.      C)  Quizzes  and/or  questions  can  be  printed out in
  29. several  formats  to  meet  the  needs  of  both teacher and
  30. student.  The solutions  to each question can  be suppressed
  31. or displayed on  a printout.   Students can receive  an echo
  32. printout of each  question they take  on- screen.   Teachers
  33. can review their database  of questions by printing  out all
  34. the  questions  or  by  defining  a  range  (from # to #) to
  35. print.
  36.  
  37.      D) Several command line instructions allow the  program
  38. to  be  "fine-tuned"  by  a  teacher  to meet the needs of a
  39. student.   These  command  line  instructions  can  force  a
  40. student to answer  "x" number of  questions before they  are
  41. permitted to exit the program.  Or the teacher can set up  a
  42. time  limit  for  the  student  where  after  "x"  number of
  43. minutes have elapsed the program will quit.
  44.  
  45.      E) Progress  charts are  kept for  each quiz  that will
  46. record  the  best  10  students'  quiz  results.  This is an
  47. excellent  way  for  a  teacher  to  track the progress of a
  48. student.  A separate  progress chart is maintained  for each
  49. quiz created.
  50.  
  51.      F) Up to  9 students can  participate in the  same quiz
  52. at a time.  Great for contests!
  53.  
  54.      G) Businesses and organizations can use a command  line
  55. instruction that will turn CREATE A QUIZ into a  stand-alone
  56. display for customers or prospects.   This can make a  great
  57. advertising tool and  counter display, testing  a prospect's
  58. knowledge of  your product.   The program  will even  prompt
  59. each user for  his name, address  and phone number  that can
  60. be retrieved later for follow- ups.
  61.  
  62.      H)  The  quizzes  that  are  created  can  be  password
  63. protected and encrypted to prevent students from altering  a
  64. teacher's questions.
  65.  
  66.  
  67. Requirements:
  68.  
  69.      No  special   requirements  are   necessary  for   most
  70. computers.   A DOS  version of  3.0 or  higher is  necessary
  71. (although  it  is  possible  that  some  2.x  versions  will
  72. work,  but  not  guaranteed).   The  program  can be used on
  73. both  monochrome  and  color  monitors.   A  printer  is the
  74. only option  that is  required IF  you wish  to create  quiz
  75. printouts.
  76.  
  77.  
  78. To start:
  79.  
  80.      To start the  program type --->  QUIZ    then press the
  81. [ENTER] or  [RETURN] key  at the  DOS prompt.   The  program
  82. will  load  itself  into   memory  in  seconds.   After   an
  83. opening screen or two, a Main Menu will appear.
  84.  
  85.  
  86. Menus:
  87.  
  88.      Selections from the Main Menu (or any menu) can be made
  89. by   moving the  highlighted bar  to the  selection of  your
  90. choice,  then   pressing  the   [ENTER]  or   [RETURN]  key.
  91. Selections also  can be  made by  pressing the corresponding
  92. first  letter  for  each  option  in  the menu list.  If you
  93. press the [ESC] key instead,  the user will be taken  to the
  94. previous menu (if any).
  95.  
  96.  
  97. To create a quiz:
  98.  
  99.      From the Main  Menu the user  can create a  NEW quiz by
  100. choosing the "Create a quiz" selection.  The user will  then
  101. be prompted for a  filename, under which all  questions will
  102. be stored to disk.  The filename entered will  automatically
  103. receive  the  extension  ".QZ".   Do  NOT  enter  the  ".QZ"
  104. extension!  Pressing the  [ESC] key at this  filename prompt
  105. will take the user back to the Main Menu.
  106.  
  107.      After a new  filename has been  entered, the user  must
  108. give the  quiz a  title and  description, and  may elect  to
  109. enter their name as the quiz creator.
  110.  
  111.      Once this preliminary information has been entered  the
  112. user will be  prompted to enter  a question.   Questions can
  113. be  up  to  four  lines  in  length.   You can move from one
  114. question line to  another by using  the cursor control  keys
  115. (the keys  with the  up and  down arrows),  or by  using the
  116. [ENTER] key.
  117.  
  118.      To move to the  answer field, press the  [F10] function
  119. key.   This key  will cause  the input  prompt to  leave the
  120. question field, allowing the user to enter possible  answers
  121. to the  previous question.   Should the  user need  to  jump
  122. back to the previous question to make any necessary  changes
  123. then  press  the  [F9]  function  key.   Pressing  the [F10]
  124. function  key  from  the  answer  field  will  instruct  the
  125. program to continue to the next step (if any).
  126.  
  127.  
  128. Multiple choice questions:
  129.  
  130.      The  multiple  choice  question  format  is the default
  131. format  when  you  enter  questions.   Each  multiple choice
  132. question can  have up  to 5  possible answer  choices and as
  133. few  as  2.   After  entering  the  desired number of answer
  134. choices, the quiz creator must verify which of the  possible
  135. answers is in  fact the correct  answer.  This  verification
  136. step will  display the  question and  possible answers  in a
  137. play  screen.   After  verifying  the  correct solution, the
  138. user can enter a reference note. Such notes will be display-
  139. ed after a student takes the quiz at play time.
  140.  
  141.  
  142. Fill-in-the-blank questions:
  143.  
  144.      Fill-in-the-blank questions are different from multiple
  145. choice  questions  in that only  one possible answer  can be
  146. entered.   The  way  CREATE  A  QUIZ distinguishes between a
  147. multiple choice  question and  a fill-in-the-blank  question
  148. is that the  latter has an  UNDERSCORE "_" character  (ASCII
  149. 95) somewhere  in the  question.   This underscore character
  150. is NOT  to be  confused with  a "dash"  or "hyphen".   If an
  151. underscore character exists  ANYWHERE in the  question, then
  152. that  question  automatically  becomes  a  fill-in-the-blank
  153. question, and will as a  result accept only one answer  when
  154. the time comes  to input an  answer when creating  the quiz.
  155. You can enter  one "_" underscore  by itself or  a string of
  156. underscores (e.g., "______").  The result is the same -  one
  157. word will be prompted for during the quiz.
  158.  
  159.      The  following  are  acceptable  in creating a fill-in-
  160. the-blank question:
  161.  
  162.      George _ was the first president of the United
  163. States.
  164.  
  165.      George Washington was the first _____ of the United
  166. States.
  167.  
  168.      Name the first president of the United States?: __
  169.  
  170.      Keep  in  mind  the   difference  in  formats   between
  171. multiple-choice and fill-in-the-blank questions:
  172.  
  173.      "DECEMBER 25 IS:"    This will result in a multiple-
  174.                           choice question.
  175.  
  176.      "DECEMBER 25 IS _"   This will result in a fill-in-
  177.                           the-blank question.
  178.  
  179.      You  can  enter  alternate  or  multiple  answers   for
  180. fill-in-the-blank  questions  by  separating each acceptable
  181. answer with a  comma ",".   For instance, if  a fill-in-the-
  182. blank question prompts:  "How  much is 50 cents added  to 50
  183. cents? _", the quiz creator can anticipate several  possible
  184. answers by entering "$1, $1.00,  1 buck, 4 quarters" in  the
  185. answer field.   Note that  each solution  is separated  by a
  186. comma ",".  When a student in confronted with this  question
  187. on the screen during  an interactive quiz, the  student will
  188. receive a  "correct" response  if they  enter any  of the  4
  189. answers:
  190.  
  191.          $1       $1.00      1 buck      4 quarters
  192.  
  193.  
  194. Edit a quiz:
  195.  
  196.      If  the  user  wishes  to  modify,  change,  or  add  a
  197. question  to  an  existing  .QZ  quiz  file, then select the
  198. "Edit a quiz" option from the Main Menu.  This feature  will
  199. permit the user  to change any  question or answer  that had
  200. been  previously  entered.   If  the  user  has  dozens   or
  201. hundreds of  questions in  a .QZ  file, and  wishes to  edit
  202. just one question,  but is uncertain  as to its  position in
  203. the file, the user can "list" all the questions in the  file
  204. quickly by pressing  the [L] key.   A pop-up menu  list will
  205. appear  that  will  list  all  the  questions  in sequential
  206. order.   If  more  questions  exist  than  can appear in the
  207. menu, use the  cursor control keys  to scroll down  the menu
  208. list.   Once  the  question  is  located  in the menu, press
  209. [ENTER]  and  that  question  and  its corresponding answers
  210. will be displayed in their  entirety.  Press the [C]  key to
  211. make any necessary "changes".
  212.  
  213.      Note: Once a question  has been entered as  a "fill-in-
  214. the-blank" type  question, it  is possible  from within  the
  215. program to  convert it  to a  multiple-choice question.   To
  216. make the switch, remove the "_" underscore character.   This
  217. will allow the  user to add  the usual five  possible answer
  218. choices.   You can  also make  the switch  from an  existing
  219. multiple-choice to  a fill-in-the-blank  question by  simply
  220. inserting  an  "_"  underscore  character  anywhere  in  the
  221. question itself.
  222.  
  223.  
  224. Quiz printouts:
  225.  
  226.      There  are  two  ways  to  obtain printed quizzes using
  227. CREATE A QUIZ:
  228.  
  229.      1) Before taking  an actual quiz,  the user can  select
  230. the "Print  quiz:" choice  from the  "Take/use a  quiz" sub-
  231. menu.  Once  the "Print quiz:"  option is toggled  "ON", all
  232. questions  that  are  displayed  on  the  screen  during the
  233. course  of  the  quiz  will  also  be  echoed  to  a printer
  234. attached  to  port  LPT1:   The  solutions  to these printed
  235. quizzes will appear after every two pages of questions.
  236.  
  237.      2)  From  the  "Create  a  quiz"  and  "Edit  a   quiz"
  238. selections from the  Main Menu, the  user can press  the [P]
  239. key to  print a  range of  questions.   The quiz creator can
  240. then  enter  the  beginning  question  number and the ending
  241. question  number.   This  range  will  then  be  sent to the
  242. printer.   The   quiz  creator  also   has  the  option   of
  243. displaying  the  correct  answer  on  these printouts, or to
  244. suppress the correct answer.  Correct answers are marked  by
  245. an asterisk symbol "*".
  246.  
  247.  
  248. Repeat errors:
  249.  
  250.      Before taking a quiz,  the user can select  the "Repeat
  251. errors:" option from the "Take/use a quiz" sub- menu.   When
  252. the "Repeat errors:" option is toggled "ON", then  questions
  253. that  have  been  answered  incorrectly  will  be saved into
  254. memory and recalled  at random during  the remainder of  the
  255. quiz session.
  256.  
  257.  
  258. Scoreboard:
  259.  
  260.      When a  user has  finished with  a quiz  and wishes  to
  261. exit to DOS, their score  will be entered into a  scoreboard
  262. file and then displayed on  the screen in a "Top-Ten"  chart
  263. if they  have one  of the  ten best  records for  that quiz.
  264. Each  quiz  that  you  create  has its own scoreboard ".SCB"
  265. file.   For  example,  if  you  have  a student using a quiz
  266. named "MUSIC.QZ"  then the  student's quiz  results will  be
  267. kept in "MUSIC.SCB" as he finishes the quiz.
  268.  
  269. Command line options:
  270.  
  271.      The "command line" refers to what was typed at the  DOS
  272. prompt  before  loading  CREATE  A  QUIZ  into  memory.  For
  273. example, if your CREATE A QUIZ disk is located in drive  A:,
  274. your screen  should display  "A>QUIZ" before  you press  the
  275. [ENTER] key to begin the program.  "A>QUIZ" can be  referred
  276. to as the "command line".
  277.  
  278.      Additional text  can be  appended to  the command  line
  279. after the key word "QUIZ"  that will instruct CREATE A  QUIZ
  280. to perform certain functions not available through the  menu
  281. selections.
  282.  
  283.      QUIZ filename.QZ
  284.  
  285.      If  a  name  of  an  existing  .QZ file is added on the
  286. command line after the key  word "QUIZ", then that .QZ  file
  287. will  be  automatically  read  and  used  to  quiz the user/
  288. student.   In such  cases the  "Main Menu"  will be skipped,
  289. and the student will be  greeted with a prompt to  enter his
  290. name, followed by  the quiz.   In the above  example replace
  291. the word  "filename" with  the actual  name of  the quiz you
  292. wish to  use.   If your  quiz is  called "MATH.QZ"  then you
  293. must  enter  "QUIZ  MATH.QZ"  on  the  command  line  before
  294. running  the  program.   An  example  of  this  command line
  295. option  in  action  can  be  seen  by  using  or viewing the
  296. "QUIZ1.BAT" file on this disk.
  297.  
  298.      QUIZ filename.QZ RESTRICT
  299.  
  300.      The  additional  word  "RESTRICT"  on  the command line
  301. will  prevent  the  student/user  from  reaching  the  "Main
  302. Menu".  This  is useful if  you have given  the program disk
  303. to  a  student and have  created a batch  file to force  the
  304. student to use  a particular quiz,  but you do  not want the
  305. student to gain  access to the  "Main Menu" where  he may be
  306. able  to  change  your  questions  or  answers,  or peek and
  307. cheat.
  308.  
  309.      QUIZ STOPAT=x
  310.  
  311.      The above "STOPAT=" command line option can be used  to
  312. force CREATE  A QUIZ  to stop  and return  to DOS  after "x"
  313. number  of  questions  have  been  attempted by the student.
  314. You can replace  the "x" with  any positive number  that you
  315. wish.   For  instance,  "QUIZ  STOPAT=2", "quiz stopat=150",
  316. "QUIZ  stopat=9000"   are  all   acceptable  command    line
  317. instructions.   Do  NOT  forget  to  separate  the  key word
  318. "QUIZ" and the "STOPAT=" option  with a space!  If  the user
  319. wishes to see an example of a .BAT file with this option  at
  320. work then see the "QUIZ2.BAT" file on this disk.
  321.  
  322.      QUIZ TIMEOUT=x
  323.  
  324.      The above  "TIMEOUT=" command  line option  can be used
  325. to force CREATE A QUIZ to  stop and return to DOS after  "x"
  326. number of minutes have elapsed since the first question  was
  327. attempted by the student.  You can replace the "x" with  any
  328. positive  number  that  you   wish.   For  instance,   "QUIZ
  329. TIMEOUT=5" will cause the program to end after 5 minutes  of
  330. play have elapsed.  An  example of this command line  option
  331. in action can be seen in the "QUIZ3.BAT" file on this disk.
  332.  
  333.      Command line instructions can be combined or placed  in
  334. any  order.   In  other  words,  the  following command line
  335. instructions are all acceptable:
  336.  
  337.      QUIZ TIMEOUT=10 STOPAT=100
  338.  
  339.      The  command  line  instructions  above  will cause the
  340. program to end after 10 minutes of play have elapsed or  100
  341. questions have been attempted, whichever comes first.
  342.  
  343.      QUIZ filename.QZ DISPLAY
  344.  
  345.      The above command line instructions force CREATE A QUIZ
  346. into a continuous loop  using "filename.QZ".  When  a player
  347. is prompted for his name,  the program will insist that  the
  348. user input his FULL name, AND address, city, state, zip  and
  349. phone  number  before  they  can  participate  in  the  quiz
  350. specified  by  "filename.QZ".   This  "DISPLAY" command line
  351. instruction  (with  .QZ  file)  turns  CREATE A QUIZ into an
  352. excellent  sales  or  promotional  tool  for  businesses and
  353. organizations.  For example,  a company that specializes  in
  354. selling  and  installing  home  water  filters  can create a
  355. "WATER.QZ" file that  presents several questions  that tests
  356. a  prospective  client's  knowledge  of tap water, chlorine,
  357. heavy metals, cost comparisons, etc.   If CREATE A QUIZ  has
  358. been  started  with  the  "WATER.QZ  DISPLAY"  command  line
  359. instructions,  then  WATER.QZ  will  be  presented  to  each
  360. client  that  approaches  the  company's  computer  display.
  361. Each user's  name and  address are  stored in  a file called
  362. "USER.LST".  The "USER.LST" file can later be retrieved  and
  363. used to print  out mailing labels  or possible client  list.
  364. Should you  wonder how  to stop  CREATE A  QUIZ from looping
  365. into eternity  in the  "DISPLAY" mode,  enter "GOODBYE" when
  366. the input window prompts for a user's full name.  Of  course
  367. you  could  reboot  your  computer,  but  that's  not   very
  368. graceful...
  369.  
  370. Disclaimer:
  371.  
  372.      The author makes  no warranties, expressed  or implied,
  373. as  to  the  quality  of  performance  of this program.  The
  374. author will  not be  held liable  for any  direct, indirect,
  375. incidental or consequential  damages resulting from  the use
  376. of CREATE A QUIZ.  Your use of the program constitutes  your
  377. agreement to this disclaimer and your release of the  author
  378. from any form of liability or litigation.
  379.  
  380.  
  381. Shareware and distribution:
  382.  
  383.      CREATE  A  QUIZ  is  being  distributed  as  shareware.
  384. Shareware  is  a  "try  before  you  buy" software marketing
  385. concept  that  allows  the  user  to obtain fully functional
  386. copies of  programs for  evaluation.   The distribution  and
  387. copying  fee  that  you  may  have  paid to obtain this disk
  388. does not cover  the cost of  the software contained  on this
  389. disk.   Shareware  programs  such  as  the  one that you are
  390. about to try  require separate payment  to the author  if it
  391. is found to be a useful  product and if it is used  beyond a
  392. reasonable evaluation period.
  393.  
  394.      Individuals can  make copies  of this  program and pass
  395. them on to friends and acquaintances as long as the  program
  396. is NOT sold  and the concept  of shareware is  made known to
  397. them.   Commercial distributors  and vendors  should contact
  398. the  author  BEFORE  distributing  CREATE  A  QUIZ publicly.
  399. Contact the author  with a self-addressed  stamped envelope.
  400. Distributors  and  vendors  who  wish  to receive the latest
  401. unregistered  version  of  CREATE  A  QUIZ  can  do  so   by
  402. contacting  the  author  AND  SUBMITTING  A  COPY  OF  THEIR
  403. PRODUCT CATALOG.
  404.  
  405.  
  406. Site licenses:
  407.  
  408.      Businesses,  groups  and  schools  must  obtain  a site
  409. license for  CREATE A  QUIZ.   Teachers who  plan on  making
  410. more than one copy of  their registered version of CREATE  A
  411. QUIZ  must  likewise  obtain  a  site  license.  Contact the
  412. author for more details.
  413.  
  414.  
  415. Program Author:
  416.  
  417.      Philip Kapusta  P.O. Box 5423  Falmouth, Va. 22403  USA
  418.  
  419. Other programs:
  420.  
  421.      If you are interested in other programs written by  the
  422. author, a demo disk and  catalog is available.  Most  of our
  423. programs are family or  Bible oriented and very  affordable.
  424. Mail   six   U.S.  first  class  postage  stamps  to   cover
  425. materials and shipping to  the above address, and  request a
  426. demo  disk  and  catalog,  and  specify  disk  size   format
  427. desired.
  428.  
  429.  
  430. .QZ quiz collection and offer:
  431.  
  432.      As a service to you, a  collection  of .QZ files   will
  433. be   maintained  that  can    be  purchased   or  exchanged.
  434. Each .QZ  file  will  contain a   minimum of 125  questions.
  435. Here is how the service works:
  436.  
  437.      1) For  every .QZ  file mailed  to the  author the user
  438. will receive a voucher to receive one .QZ file in exchange.
  439.  
  440.      2) A  database disk  of all  .QZ files  can be obtained
  441. once a user has  mailed in five .QZ  files or more.   Or the
  442. database  disk  listing  all  available  .QZ  files  can  be
  443. obtained separately  in exchange  for six   U.S. first class
  444. postage stamps.  Specify disk format desired.
  445.  
  446.      3) Individual .QZ  files can be  purchased if the  user
  447. does not wish to exchange or mail in their .QZ files.
  448.  
  449.      4) Only .QZ files that have a MINIMUM of 125  questions
  450. are  eligible  for  inclusion  into the database collection.
  451. All .QZ files must contain  your name, quiz title, and  quiz
  452. description (these are  automatically entered as  you create
  453. each .QZ file  within CREATE A  QUIZ).  Only  .QZ files with
  454. useful educational  questions are  permitted.   We will  not
  455. accept  trash!   All  .QZ  files  are  scanned  and anything
  456. vulgar or  objectionable will  be refused.   Here is  just a
  457. sample  of   acceptable  .QZ   file  subjects:   automotive,
  458. business,  foreign  language,  vocabulary,  math,  religion,
  459. computer, environment, music, nutrition, trivia,  financial,
  460. history, sports, politics, current events.  The list can  go
  461. on and on...   But again, NOTHING  VULGAR OR  OBJECTIONABLE.
  462.  
  463.      5)  .QZ  files  sent  to  us  on  a  disk  MUST INCLUDE
  464. SUFFICIENT RETURN POSTAGE or  else we will not  be obligated
  465. to return  your voucher  or exchange  .QZ files.   This is a
  466. service,  not  a  charity!   We  will,  however, provide the
  467. return envelope.
  468.  
  469.  
  470. Your feedback:
  471.  
  472.      We welcome all  feedback - positive  and negative.   We
  473. will   consider   your   suggestions   for   future  program
  474. enhancements.   If  you  desire  a  reply,  enclose  a self-
  475. addressed stamped envelope when writing.
  476.  
  477.